home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 1 / Amiga Tools.iso / splitter.doc < prev    next >
Text File  |  1994-06-06  |  15KB  |  410 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                               (WB)FileSplitter V 1.2
  13.                               ----------------------
  14.  
  15.                         Programmierung, Konzept, Idee: MMR
  16.  
  17.                                   © 1992 BY MMR ©
  18.  
  19.  
  20.                         Nur fuer Kick 2.0 (V37.) aufwaerts
  21.                         **********************************
  22.                                     >Freeware<
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. Inhalt:
  33. -------
  34.    1.   FileSplitter         ---> WB-CLI Version
  35.    2.   FileSplitter.info    ---> Sehr wichtig fuer Gundeinstellung
  36.    3.   FileSplitter.dok     ---> Dies File hier....
  37.  
  38.  
  39. Benoetigte Lib:
  40. ---------------
  41.    Libs: reqtools.library.....V37.?? oder hoeher
  42.    Lha/Lzh/arc kompatiebler Packer
  43.  
  44.  
  45.  
  46.  
  47. Allgemeines
  48. -----------
  49.  
  50. Mit dem FileSplitter ist es moeglich, sich ein File oder mehrere Files aus
  51. einem [.lha/.lzh] File zu entpacken.
  52. Desweiteren ist es auch moeglich Files und Directorys zu selektieren und
  53. diese zu packen, als extra File.lha oder an ein File anzuhaengen.
  54.  
  55. Warum denn sowas?
  56. Vielleicht moechte man sich nur mal das Doc.File oder Programmfile aus einem
  57. Paket entpacken lassen, und wenn das Paket 600 KB gross ist (und man kein
  58. Besitzer einer Turbokarte ist), kann das ganz schoen nerven bis das Paket
  59. entpackt ist, evtl. hat man auch zu wenig Speicher um das ganze Paket ins
  60. RAM: zu entpacken, usw....
  61. Mittlerweile bin ich bei der Version 1.2 angelangt, mit dieser ist es nun
  62. auch moeglich File(s) oder Directorys zu packen, also ist der FileSplitter
  63. schon sowas wie eine Benutzeroberflaeche fuer den LHA.
  64.  
  65.  
  66. Installation
  67. ------------
  68.     CLI:  Einfach FileSplitter eingeben und Return druecken.
  69.  
  70.           Beim CLI-Start werden keine Eingabeparameter erwartet, d.h.
  71.           der FileSplitter benutzt seine internen Werte, also die
  72.           die Defaultwerte, diese koennen aber jederzeit geaendert werden!
  73.           Als da waeren:
  74.  
  75.  
  76.               GADGETS             Einstellung
  77.               -------             -----------
  78.  
  79.           1.  Showlist           aktiviert
  80.           2.  Showextract        aktiviert
  81.           3.  Suchpfad           Default Pfad   SYS:
  82.           4.  Packerpfad         Default Packer c:LHA
  83.           5.  Optionen                  ----
  84.           5.1 |-- Outputwindow   Default CON:10/30/620/198/Filesplitter Output
  85.           5.3 |-- Entpackoption  Default e
  86.           5.4 |-- Packoption     Default -w -x a
  87.           6.  Zielpfad           Default Pfad   RAM:
  88.           7.  Windowdelay        Default 2 Sekunden
  89.  
  90.  
  91.      WB:  Einfach auf das Icon doppelklicken
  92.  
  93. WICHTIG:  Das Icon enthaelt wichtige >Tooltype< Eintraege,also
  94.           einmal anklicken, dann in der Menueleiste >Piktogramm/Information
  95.           oder mit R-AMIGA-I, das Tooltypearray editieren!
  96.  
  97.  
  98.           1. SHOWLIST=        YES/NO
  99.           2. SHOWEXTRACT=     YES/NO
  100.           3. OUTPUTWINDOW=    Definiert das Extrackt/Packwindow
  101.           4. ZIELPFAD=        Das Destination Directory
  102.           5. PACKERPFAD=      Den Pfad und Packer
  103.           6. SUCHPFAD=        Das Directory zum LHA Files einlesen
  104.           7. ENTPACKOPTION=   Die Optionen des LHA zum entpacken
  105.           8. PACKOPTION=      Die Optionen des LHA zum packen
  106.           9. WINDOWDELAY=     Zeit die verstreicht bis das window schliesst
  107.  
  108.  
  109.           Diese Einstellungen werden dann vom FileSplitter uebernommen.
  110.           -------------------------------------------------------------
  111.  
  112. Arraytypen: SHOWLIST=YES/NO        ....listet das .lha File in einem Shell
  113.                                        Window auf, eigendlich nur wichtig
  114.                                        um festzustellen ob das File ok ist.
  115.                                      * siehe auch WINDOWDELAY, OUTPUTWINDOW
  116.  
  117.  
  118.             SHOWEXTRACT=YES/NO     ....listet das selektierte File in einem
  119.                                        Shell-Window auf, auch nur wichtig
  120.                                        um festzustellen ob das File ok ist.
  121.                                      * siehe auch WINDOWDELAY, OUTPUTWINDOW
  122.  
  123.  
  124.             OUTPUTWINDOW=CON:10/30/620/200/Outputwindow
  125.                                    ....hier koennen die Shell-Window
  126.                                        groessenangaben eingestellt werden,
  127.                                        Diese Optionen werden genauso wie
  128.                                        im CLI erwartet
  129.                                      * siehe auch SHOWEXTRACT, WINDOWDELAY
  130.                                        SHOWLIST
  131.  
  132.                    Die Parameter werden genauso wie im CLI erwartet
  133.  
  134.             also:  CON:10/30/620/200/Windowname
  135.                     |  |  |  |   |   |_____________Titel des Fensters
  136.                     |  |  |  |   |_________________Hoehe in Bildpunkten
  137.                     |  |  |  |_____________________Breite in Bildpunkten
  138.                     |  |  |________________________Y-Startpunkt des Fensters
  139.                     |  |___________________________X-Startpunkt des Fensters
  140.                     |______________________________Device
  141.  
  142.  
  143.             ZIELPFAD=RAM:          ....hier kann der Pfad des entpackten
  144.                                        Files.lha eingestellt werden, z.B.:
  145.                                        DF0:, DH0:Tools usw.
  146.  
  147.  
  148.             SUCHPFAD=DH1:Download  ....hier kann das Directory eingestellt
  149.                                        werden, in dem man die .lha Files
  150.                                        liegen hat.
  151.  
  152.  
  153.             PACKERPFAD=C:LHA       ....hier wird der Pfad und der Packer
  154.                                        eingestellt.
  155.  
  156.  
  157.             ENTPACKOPTION=e        ....hier die Option (e) entpacken
  158.  
  159.  
  160.             PACKOPTION=-w -x a     ....hier -w = set Workdirectory, sehr
  161.                                        wichtig damit nur die selektierten
  162.                                        File und Diectorys gepack werden und
  163.                                        nicht der komplette Pfad ab dem
  164.                                        Devicenamen.
  165.                                        -x = Use Pathnames
  166.                                        a = add also packen
  167.  
  168.  
  169.             WINDOWDELAY=2          ....Die Wartezeit bis das Shell-Window
  170.                        (0)             wieder geschlossen wird.
  171.                                        Wird der Wert 0 eingegeben, erscheint
  172.                                        im Outputwindow der Text
  173.                                        "Press RETURN..."
  174.                                        Das Window bleibt solange geoeffnet
  175.                                        bis mit RETURN bestaetigt wird!!
  176.  
  177.  
  178.  
  179.  
  180. Benutzung
  181. ---------
  182.                                   FEHLER
  183.                                 **********
  184.  
  185. Sollte etwas mit den Optionen nicht stimmen, z.B. ein Zeichen vergessen,
  186. Windowgroesse stimmt nicht, falscher Pfad, wird dieses mit einem aufblitzen
  187. des Screen angedeutet.                                           ^^^^^^^^^^
  188.  
  189. Um an die Default-Einstellungen zu gelangen, braucht man nur einmal CANCEL
  190. im Requester (fuer alle Optionen, Zielpfad, Packerpfad, Suchpfad)   ^^^^^^
  191. bestaetigen, und die Standartoptionen werden uebernommen.........
  192. Diese Optionen waeren dann mit den der CLI-Eingabe identisch!
  193.  
  194.  
  195.  
  196. Nach dem starten...
  197. -------------------
  198.  
  199. Taste=R-AMIGA-Q oder das Closewindow-Gadget
  200. -------------------------------------------
  201.  
  202.    Hiermit wird das Programm beendet, bzw. auch mit dem Menueeintrag QUIT.
  203.  
  204.  
  205. Show List und Show Extract
  206. --------------------------
  207.  
  208.    Die Gadgets Show List und Show Extract sind zum ueberpruefen des Files
  209.    gedacht, z.B. kann das File ein CRC-Error haben, und dieses merkt man nur
  210.    an dem Output des Packers und dem Returncode und evtl. gefolgt von einem
  211.    aufblitzen des Screen......
  212.  
  213.  
  214. Taste=SPACE oder das Cycel-Gadget
  215. ---------------------------------
  216.  
  217.    Das Cycel-Gadget beinhaltet drei Moeglichkeiten:
  218.  
  219.     1.  Information         ...kleines Info
  220.     2.  File entpacken      ...das .lha File anwaehlen
  221.     3.  File(s) packen      ...Files und Directorys packen
  222.     4.  Palette             ...Farben aendern
  223.  
  224.    Diese Funktionen koennen auch mit der SPACE-TASTE durchgeblaettert werden
  225.    Zu aktivieren sind diese dann mit dem Starten-Gadget, oder R-AMIGA-S
  226.  
  227.  
  228. Taste=R-AMIGA-S oder das Starten-Gadget
  229. ---------------------------------------
  230.  
  231.    Mit diesem Gadget werden die Aktionen ausgefuehrt die im Cycel-Gadget
  232.    selektiert wurden.
  233.  
  234.  
  235. Taste=R-AMIGA-P oder das Packerpfad-Gadget
  236. ------------------------------------------
  237.  
  238.    Hier wird der Packer gewaehlt, z.B. LHA oder LZ.
  239.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert c:LHA uebernommen.
  240.  
  241.  
  242. Taste=R-AMIGA-Z oder das Zielpfad-Gadget
  243. ----------------------------------------
  244.  
  245.    Hier wird der Zielpfad (Greraet/Directory) angewaehlt, z.B. RAM:, DH0:Tool
  246.    Wird im Requester CANCEL gewaehlt, wird der Dafaultwert RAM: uebernommen.
  247.  
  248.  
  249. Taste=R-AMIGA-O oder das Optionen-Gadget
  250. ----------------------------------------
  251.  
  252.    Es erscheint ein neues Window, indem die Pack, Entpack, und Windowoptionen
  253.    eingestellt werden koennen.
  254.    Das Eingabeformat etspricht dem des Tooltypearrays, bitte dort nachlesen!
  255.    Wird im Requester CANCEL gewaehlt, wird der Defaultwert fuer:
  256.  
  257.    1.       Outputwindow: CON:10/30/620/198/Filesplitter Output
  258.  
  259.    3.       Packeroption: e
  260.  
  261.    4.      Entpackoption: -w -x a
  262.  
  263.    uebernommen.
  264.  
  265.  
  266.  
  267.                               Los gehts
  268.                              ***********
  269.  
  270.  
  271. Also dann, Files entpacken:
  272. ---------------------------
  273.  
  274. Das Cycelgadget auf File entpacken stellen und einmal auf das
  275. Startengadget klicken. Es erscheint ein Filerequester in dem das File
  276. angewaehlt werden kann. Sollte das Gadget Show List aktiv sein, wird ein
  277. Listing ausgegeben.
  278. Sollte alles richtig eingestellt sein erscheinen 5 neue Gadgets.
  279. Nun erscheint eine Liste der Files aus dem .lha Paket, diese brauchen
  280. einfach nur einmal angeklickt zu werden! Sollte das Gadget Show Extract aktiv
  281. sein, wird das entpacken in einem Shell-Window angezeigt.
  282. Nach dem entpacken wird das selektierte File aus der Liste geloescht!
  283.  
  284. Wird das Multi-Wahl Gadget einmal angeklickt (dadurch wird das Multi-Doit
  285. Gadget waehlbar), kann ab sofort in das Listwindow geklickt werden ohne das
  286. die Files sofort ertpackt werden. Erst nach bestaetigen des Multi-Doit
  287. Gadgets werden die selektierten Files entpackt, oder aber es wurde das
  288. letzte File in der Liste angeklickt, dann wird automatisch entpackt.
  289.  
  290. Um die Multi-wahl Funktion wieder abzuschalten, genuegt es einmal auf das
  291. Multi-Doit Gadget zu klicken, aber nur wenn noch kein File selektiert worden
  292. ist, wurden Files selektiert, werden dieses erst entpackt!
  293.  
  294. Das Nix mehr Gadget bricht alles ab und fuehrt wierder zum Hauptmenue.
  295. Das New File Gadget bricht alles ab und fuehrt sofort wieder in den
  296. Fileauswahl Requester um ein neues File zu selektieren.
  297. Sollte das Multi-Wahl Gadget gerade aktiv sein und es wurden Files
  298. selektiert, werden dies ignoriert!!
  299.  
  300.  
  301.  
  302. Taste=R-AMIGA-N oder das Nix mehr-Gadget
  303. ----------------------------------------
  304.  
  305.    Hiermit gelangt man wieder in den Anfangszustand des Programms um evtl. ein
  306.    neues File zu laden, oder die Optionen aendern zu koennen.
  307.  
  308.  
  309. Taste=R-AMIGA-F oder das New File-Gadget
  310. ----------------------------------------
  311.  
  312.    Hiermit gelangt man sofort in den Filerequester, um ein neues File
  313.    einzulesen! Die durch Multi-Wahl selektierten Files werden nicht mehr
  314.    entpackt.
  315.  
  316.  
  317. Taste=R-AMIGA-M oder das Multi-Wahl-Gadget
  318. ------------------------------------------
  319.  
  320.    Dieses Gadget wird nach dem anklicken inaktiv und das Multi-Doit Gadget
  321.    aktiv. Dies bedeutet, das alles jetzt angeklickten Files gepuffert werden
  322.    und erst dann entpackt werden wenn das Multi-Doit Gadget angeklickt wird,
  323.    oder das letze File in der Liste selektiert wurden ist.
  324.    Wurde kein File selektiert und man klickt in das Multi-Doit Gadget, blitz
  325.    der Screen einmal, und man gelang wieder in den Entpackmodus einzelner
  326.    Files.
  327.  
  328.  
  329. Taste=R-AMIGA-D oder das Multi-Doit-Gadget
  330. ------------------------------------------
  331.  
  332.    Diese Gadget ist nur aktiv wenn das Multi-Wahl Gadget aktiviert worden
  333.    ist. Hiermit werden die selektierten Files dann entpackt.
  334.    Sollten noch Files in der Liste vorhanden sein die nicht selektiert
  335.    wurden, werden diese wieder angezeigt.
  336.  
  337.  
  338. File(s) packen:
  339. ---------------
  340.  
  341. Das Cycelgadget auf File(s) packen stellen, und einmal das Startengadget
  342. anklicken. Es erscheint nun ein MULTISELECT-REQUESTER, das heisst, um
  343. mehrere Files oder auch Directorys zu selektieren haelt man einfach die
  344. SCHIFT-TASTE gedrueckt und klickt das File oder Directory EINMAL an.
  345. Ich hoffe das mit dem Requester jeder vertraut ist, er bietet wirklich sehr
  346. viel Optionen.
  347. Gut, nach dem selektieren erscheinen wieder 4 neue Gadget und ein Listgadget!
  348. In diesem werden jetzt alle selektierten Files und Directory angezeigt.
  349. Mit Abbruch wird sofort wieder zum Startmenu gesprungen.
  350. Ein Klick auf das Remove Gadget aktiviert dieses, dadurch werden die anderen
  351. Gadget inaktiv, ein nochmaliger Klick auf das Remove Gadget schaltet die
  352. Remove Funktion wieder ab, dadurch werden die anderen Gadget wieder aktiv.
  353. Bei aktivem Remove kann jetzt in die Liste geklickt werden um Files oder
  354. Directorys zu loeschen, falls man diese doch nicht packen moechte!
  355. Bei Nichtaktivem Remove kann jetzt einfach in die Liste geklickt werden und
  356. diese File oder Directory wird dann gepack, in diesem Moment erscheint ein
  357. neuer Requester in dem man den Pfad und Filenamen angeben kann.
  358. Ein Klick auf das Packen Gadget packt alle Files und Directorys in der List
  359. und spring dann in das Startmenu zurueck. Auch hier wird nach dem Pfad und
  360. Filenamen durch ein Requester gefragt, sollte dies nicht vorher schon
  361. geschehen sein.
  362. Ein Klick auf das File dazu Gadget packt alles Files oder Directorys in der
  363. Liste, sollte noch kein Filename existieren wird auch diese per Requester
  364. erfragt. Danach wird sofort wieder der MULTISELECT-REQUESTER aufgerufen um
  365. neue Files oder Directorys zu selektieren. Doch bei diesem Gadget wird
  366. spaeter nicht mehr nach dem Pfad und Filenamen fuer das Packfile gefragt,
  367. also werden die Daten an das bestehende File.lha angehaent.
  368.  
  369.  
  370. Taste=R-AMIGA-A oder das Abbruch-Gadget
  371. ---------------------------------------
  372.  
  373.    Dieses Gadget bricht alles ab und springt in das Startmenu.
  374.  
  375.  
  376. Taste=R-AMIGA-P oder das Packen-Gadget
  377. --------------------------------------
  378.  
  379.    Hiermit werden die Files oder Directorys in der Liste gepackt, es wird
  380.    mit einem Requester der Pfad und Filename erfragt, danach gelangt man
  381.    wieder in das Startmenu
  382.  
  383.  
  384. Taste=R-AMIGA-R oder das Remove-Gadget
  385. --------------------------------------
  386.  
  387.    Wird in dieses Gadget geklickt, aktiv wenn die anderen Gadgets
  388.    inaktiv sind, kann ein File oder Directory aus der Liste geloescht werden
  389.    indem man das File oder Directory anklickt.
  390.    Ein nochmaliger Klick in das Remove Gadget hebt diese Funktion wieder
  391.    auf, erkenntlich an den anderen aktiven Gadgets. Ab jetzt kann wieder ein
  392.    einzelnes File oder Directory gepackt werden indem man es einfach in der
  393.    Liste anklickt.
  394.  
  395.  
  396. Taste=R-AMIGA-F oder das New File-Gadget
  397. ----------------------------------------
  398.  
  399.    Wird dieses Gadget angeklickt, werden die Eintraege der Liste gepackt und
  400.    danach erscheint der MULTISELECT-REQUESTER um neue Files zu selektieren, die
  401.    dann wieder an das bestehende File.lha gepackt werden.
  402.  
  403.  
  404. Hmm, das waere dann schon das Groebste, denk ich.
  405.  
  406.  
  407.  
  408. MMR.........(Barney)
  409.  
  410.